Checkout the GeoServer Sources

Downloading Source Release

You can download the latest source code release from the GeoServer download page.

Source code releases are made available every two to four weeks if possible. The current stable branch is 1.4

If you just want to check out the code, using the download is appropriate. However if you wish to contribute back patches then you must work off of the svn version, documented below.

Subversion Repository

The GeoServer source code is located in the Codehaus Subversion Repository.

Repository Structure

The GeoServer subversion repository follows a standard layout:

https://svn.codehaus.org/geoserver/
    branches/
    tags/
    trunk/

Post 1.5, the source tree for each development branch was split into two parts:

1. "geoserver", the geoserver sources
2. "configuration", the files used to configure geoserver

You need to check out both (Configuration and Geoserver). So, on your system you should have this:

[my_geoserver]/
  + configuration/
  + geoserver/

The configuration part of the geoserver source tree contains a lot of binary data, which makes checking it out expensive. If you are using a connection in which bandwidth is at a premium, or you do not need any of the configuration files, then it is recommended that you check out only the sources and not the configuration.

When you have checked out the data, it is convenient to point geoserver at the configuration directory. You can do this by creating an environment variable called *configDirectory' and point it to the configuration directory that you just checked out. (Do not point it at any of the sub-directories, just at the configuration one.)

Trunk Source

Trunk sources are available from https://svn.codehaus.org/geoserver/trunk/geoserver.

Branch Source

Branch sources are available from https://svn.codehaus.org/geoserver/branches.

Checking Out

Checking out the source code is dependent on the subversion client you decide to use. Subversion installation instructions are located here.

Important You must use the attached subversion configuration file. It ensures that newlines are handled correctly by subversion across platforms. Without it you will suffer conflicts when you commit. Windows users should copy this file to C:\Documents and Settings\ %USERID% \Application Data\Subversion\config. You will need to have view system folders turned on to see "Application Data" in explorer. You'll also need to create the subversion folder. Linux / Unix users should copy this file to ~/.subversion/config

For more information about subversion, read subversion book. It is an important read if you are new to subversion. There are also some tips and tricks located here.

Command Line Client

Command line access is similar to CVS. Once again your best reference is the subversion book. To checkout use the following command:

svn co https://svn.codehaus.org/geoserver/trunk/

If you just want the sources and no configuration files use:

svn co https://svn.codehaus.org/geoserver/trunk/geoserver

Tortoise SVN

• Create a folder for GeoServer to live in

  C:\java\geoserver
  

• Navigate to the folder, and right-click
• Select SVN Checkout ...
  • URL of Repository: *https://svn.codehaus.org/geoserver/trunk/*
  • Checkout directory: C:\java\geoserver
  • Revision: Head Revision
• Press OK
  

Tortoise SVN includes a command client as a windows shell extension.

Netbeans

A Netbeans profile is available here.

To ignore the ubiquitous .svn folders:

• Click the filesystem node
• Set the Ignored Files property to include '.svn'

Eclipse / Subclipse

Eclipse plug-in support is provided by Subclipse a detailed guide is available in Eclipse Developers Guide.

If you are using Subclipse, you need the latest version because earlier versions would give Server certificate verification failed: issuer is not trusted error. The new version will prompt you when this happens and you should perminently accept the certificate. Subclipse will ask you for a username/password when you do your first write.

gs_tortoisesvn_chekout.png (image/png)
config (application/octet-stream)

If you are behind a proxy, you need to create a 'servers' file in the same place as the 'config' file mentioned above. In it, you should have something like: [groups] geoserver = svn.codehaus.org, svn.openlayers.org [geoserver] http-proxy-host = your.proxy.host http-proxy-port = 8080 http-proxy-username = your_username http_proxy-password = your_password Obviously you should change the host, port number, and use your username and password. Remove the username and password lines completely if you dont need to use one with your proxy server. Posted by miles at Jul 12, 2007 20:59